home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / EDITOR / QP275.ARJ / QP.DOC next >
Text File  |  1991-11-03  |  25KB  |  649 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                          Q U I C K P R I N T
  16.  
  17.  
  18.                         An easy  and fun to use
  19.                         text file print utility
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                                Version 2.75
  44.                                                November 03, 1991
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.                              DISCLAIMER
  61.  
  62.  
  63.          QuickPrint is provided as is, free of charge. There are no
  64.     warranties written or otherwise implied.  While no problems are
  65.     expected the author assumes no responsibilty for damage to data
  66.     or hardware that arises out of the use of this program.
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.                             INTRODUCTION
  119.  
  120.  
  121.  
  122.           QuickPrint is a handy and easy to use ASCII text print
  123.      utility.  Some of the highlights of the program are:
  124.  
  125.           -    It is "human engineered" (ergonomically designed) to
  126.                provide  maximal visual input with a minimum of fuss
  127.                (more on this later).
  128.  
  129.           -    Very few keystrokes are needed to load, view and print a
  130.                file.
  131.  
  132.           -    It tells you how many pages will be printed before
  133.                printing starts.
  134.  
  135.           -    It has a progress bar to give you quick input on the
  136.                status of the printing.
  137.  
  138.           -    It tells you which page is currently being sent to
  139.                the printer.
  140.  
  141.           -    The number of the print page you are viewing is displayed.
  142.  
  143.           -    The picklist is large, easy to read, alphabetically
  144.                sorted, includes the most important file information and
  145.                searches for names alphabetically.
  146.  
  147.           -    Works with color and monochrome monitors.
  148.  
  149.           -    Will automatically provide pagination and footers (page
  150.                numbers) for unformatted files.  If a file is formatted
  151.                with form feeds then QuickPrint will not add formfeeds
  152.                or footers.  Footers can be toggled off.
  153.  
  154.           -    Files can be tagged for easy printing of multiple files.
  155.  
  156.           -    Can print with or without line numbers.
  157.  
  158.           -    Can change number of lines printed per page.
  159.                ( Default is 58 lines not including the footer ).
  160.  
  161.           -    Can add margins to left side of page.
  162.  
  163.           -    Can print blocks of text.
  164.  
  165.           _    Can delete and rename files.
  166.  
  167.           The major design philosophy behind QuickPrint's development
  168.      was that it should be a no frills, easy to use print utility that
  169.      will automatically provide pagination and page numbers.
  170.  
  171.           This makes it an excellent tool for printing Readme and
  172.      documentation files provided on disks with programs.  It is also
  173.      ideal for programmers wanting to print hardcopies of their code.
  174.  
  175.  
  176.  
  177.  
  178.  
  179.                         USING QUICKPRINT
  180.  
  181.      A.   THE PICKLIST
  182.  
  183.           QuickPrint has been compiled as QP.EXE.  It can be started by
  184.      typing QP alone or following it with a filename.  If no name is
  185.      provided a picklist will be displayed. Starting with version 2.60
  186.      QuickPrint now handles command line arguments with more flexibility.
  187.      Typing a directory on the command line (i.e. QP direct\sub1\sub) will
  188.      list the files in that directory. You can also follow the directory
  189.      with a filename and you will go directly into that file. Dos wildcards
  190.      are also supported ( i.e QP c:\temp\file.* ).
  191.  
  192.           The long horizontal window bar on the bottom displays identification
  193.      and the number of files in the directory. The central picklist window
  194.      displays the current directory's filenames, 21 names per display, sorted
  195.      alphabetically. The highlight bar is placed approximately in the middle
  196.      of the list to provide equal access to the filenames.
  197.  
  198.           The following keys will work to allow navigation through the
  199.      list:
  200.  
  201.           Home - This will put the highlight bar at the top on the very
  202.           first file.
  203.  
  204.           End - This puts the bar at the bottom on the very last
  205.           filename.
  206.  
  207.           PgDn - This pages down through the list displaying 21
  208.           filenames at a time.
  209.  
  210.           PgUp - Same as PgDn except pages up through the list.
  211.  
  212.           Up Arrow - Scrolls up through the list, one filename at a
  213.           time.
  214.  
  215.           Dn Arrow - Scrolls down through the list.
  216.  
  217.           Alpha Numeric - Any filename starting with a printable ASCII
  218.           character may be searched for by pressing the appropriate key.
  219.           For example, pressing the 'A' key will place the highlight bar
  220.           on the first filename starting with an A.  When possible this
  221.           name will be placed in the middle of the display.  This is not
  222.           case sensitive. Subsequent presses will scroll through the list
  223.           of files starting with that character. If possible, the
  224.           highlighted filename will remain in the middle of the list.
  225.  
  226.           Esc - Pressing the escape key terminates the program and
  227.           places you at the DOS prompt.
  228.  
  229.           Enter - Pressing the <Enter> key starts the main program and
  230.           loads the file currently highlighted. ** NOTE ** If you
  231.           tagged several files for printing, pressing <Enter> will
  232.           put you into a large window with the names of the tagged
  233.           files displayed.  The text is NOT viewed in the window
  234.           when printing multiple files like it is when only a single
  235.           ( untagged ) file is selected.  Keeping this in mind you may
  236.           want to view the files individually before tagging them.
  237.  
  238.           Space bar - The space bar will tag/untag a file for printing.
  239.           It serves as a toggle. This is used to create a list of several
  240.           files that are to be printed consecutively in the order they
  241.           are selected. When a file is tagged an asterick ( * ) will
  242.           appear next to the name.
  243.  
  244.           Alt-D  - This combination will untag all files at once.
  245.  
  246.           Alt-F2 - Deletes a file.  You will be given the ususal prompt
  247.           requiring a response before the file is deleted.
  248.  
  249.           Alt-F3 - Renames a file.  You can rename a file according to
  250.           DOS standards.  Incorrect names will result in an error.  If
  251.           you activate this feature and decide to leave the name as is,
  252.           simply leave the line blank and press enter.
  253.  
  254.  
  255.       B.  VIEWING FILES
  256.  
  257.           Quickprint is meant to print files and is relatively crude at
  258.      displaying them.  This feature is provided so you can quickly scan
  259.      the file to determine if it's worth printing.  The selected file is
  260.      loaded into available memory.  If not enough memory is available,
  261.      only that which will fit into memory will be loaded.  The rest of
  262.      the file will be truncated.   If this occurs, you will see 'TR'
  263.      displayed in the lower window bar just prior to the '<ESC>
  264.      to quit' message.  This has no affect on printing.  Despite
  265.      truncation, the ENTIRE file will be printed.  The file is printed
  266.      from the disc, not from memory.  Individual lines longer than 80
  267.      characters will be truncated to 80 characters on the display but
  268.      again, this does not affect the printed form.
  269.  
  270.           Because QuickPrint has to read the entire document one line at
  271.      a time, and formats each line for display, some longer files may
  272.      take quite a few seconds to be read, especially if on a floppy
  273.      disk.  After this is accomplished however, the file will be in
  274.      memory and no additional disk reads will be needed.
  275.  
  276.  
  277.           THE UPPER BAR WINDOW
  278.  
  279.           The left hand side of the bar displays the filename. To the
  280.      right of the filename it is indicated that F1 pulls up the
  281.      help screen. After viewing the help screen you may return to
  282.      viewing your document by pressing either the space bar, return
  283.      or escape keys.
  284.  
  285.           You will then see "Txt Width= 80".  This indicates how many
  286.      characters you will be printing per line.  This comes in handy when
  287.      printing in compressed mode for example and you desire to print more
  288.      than the standard 80 characters per line. *THIS IS NOT A RIGHT HAND
  289.      MARGIN*. This should be used only when you have configured your printer
  290.      to print other than 80 characters per line, such as compressed mode or
  291.      you are using fonts that print other than 80 characters per line. The
  292.      purpose of this to allow quickprint to properly format the text,
  293.      keep correct count of lines printed and to properly print the footer.
  294.      This can accessed by pressing the ALT-W combination. Valid values
  295.      are 5 - 250 characters.
  296.  
  297.           The keys operable while viewing a file are as follows:
  298.  
  299.                Alt-P - Pressing the Alt-P combination immediately
  300.                        starts printing.
  301.  
  302.                Alt-L - Will print with line numbers.
  303.  
  304.                Alt-M - Will set left hand margin. Valid margins
  305.                        are from 0 to 70 spaces.
  306.  
  307.                Alt-N - Sets number of lines printed per page.
  308.                        Valid numbers are 1 to 250.
  309.  
  310.                Alt-F - Send formfeed to printer
  311.  
  312.                Alt-R - Send linefeed to printer
  313.  
  314.                Alt-C - This version does not automatically count
  315.                        the number of pages to print. This allows
  316.                        for much quicker loading of the file. You
  317.                        can get a count of the pages by pressing
  318.                        the Alt-C combination. The count will be
  319.                        displayed on the bottom line and will be
  320.                        provided in any case when you start printing
  321.                        since the program needs this information to
  322.                        track the progress of the print job.
  323.  
  324.                Alt-X - This will immediately exit the program without
  325.                        returning to the file directory.
  326.  
  327.                Alt-F5 - Toggles on and off the printing of the footer
  328.                         ( filename, date, time and footer line ).
  329.  
  330.                Alt-F6 - Toggles printing of page number.
  331.  
  332.                Alt-W  - Set number of characters per printed line
  333.                         ( see above ).
  334.  
  335.      Block commands:
  336.  
  337.                F7 - Turn on the block feature.
  338.  
  339.                F8 - Locks the block.
  340.  
  341.                ALT-U - Unmarks the block of text.
  342.  
  343.      Navigational keys while viewing a file are:
  344.  
  345.              Home - This puts you at the very beginning of the file.
  346.                 Twenty three lines are displayed at a time.
  347.  
  348.              End - This puts you at the very end of the file.  If the
  349.                 file was truncated due to memory limitations, the last 23
  350.                 lines of the shortened file will be displayed.
  351.  
  352.              Up and Down Arrows - Scrolls the cursor one line at a time
  353.                 in their respective directions.
  354.  
  355.              Left and Right Arrows - puts the cursor at the top and
  356.                 bottom of the screen respectively.
  357.  
  358.              PgUp and PgDn - Move through the file one screen at
  359.                 a time, backward or forward respectively.
  360.  
  361.  
  362.           On the far right is the page number. This corresponds with
  363.      the printed page numbers.  NOTE: This is different than earlier
  364.      versions where this was the display screen number which did not
  365.      correspond to printed page numbers.
  366.  
  367.  
  368.  
  369.           THE LOWER BAR WINDOW
  370.  
  371.           This is a rather dynamic window.  Most messages and
  372.      pertinent information will be displayed here.  When viewing
  373.      the file the line number will be displayed on the left hand
  374.      side. Then, either TOP or END will be displayed if you are
  375.      at the very top or bottom of the file. Then you will see the
  376.      word BLOCK if you have have turned on the block function (F7).
  377.      More information on the block function follows shortly.
  378.      Next, the number of print pages is given.  This number will
  379.      appear only if you first press Alt-C to get a count of the pages,
  380.      or if you print the file then return to viewing it. This is how
  381.      many pages the printed document will be.  If the document contains
  382.      formfeeds this number gives a count of them.  Otherwise, a printed
  383.      page contains 58 lines of print, not including the margins and footer.
  384.      This provides roughly a one-half inch margin both at the top and
  385.      below the footer.
  386.  
  387.           Fifty eight lines printed per page is the default number.
  388.      This can be changed by pressing the ALT-N key combination. The
  389.      acceptable range of lines per page is 1 to 250. Fifty five (or less)
  390.      is recommended for laser printers. A larger number can cause the
  391.      footer to be pushed onto the next page.
  392.  
  393.           To the right of the page count the amount of lines printed
  394.      per page will be diplayed as "Li=58" with the 58 being replaced
  395.      by the proper number should you decide to change the number. If
  396.      you change this number the amount of pages to be printed will be
  397.      adjusted accordingly.
  398.  
  399.  
  400.           Just to the right of this number is the size of the margin.
  401.      The default is 0 ( "M=0" ). If the number is changed it will be
  402.      reflected in this display. For example, "M=5" for a margin of
  403.      5 spaces. The page count is not updated to reflect margin changes.
  404.  
  405.           If you select either Alt-M or Alt-N then decide to leave the
  406.      value as is, pressing enter without inputing any numbers will
  407.      abort the process and the values will remain unchanged.
  408.  
  409.           If the file was too big to fit in memory the letters "TR"
  410.      will appear after the margin number to indicate that the file
  411.      was (TR)uncated to fit in memory. Again, this has no effect on the
  412.      final print job.
  413.  
  414.           You will then see "FN". These two letters indicate that the
  415.      (F)ooter and page (N)umber will be printed.  You can toggle the
  416.      printing of these two components by pressing the Alt-F5 combination
  417.      for the footer and Alt-F6 for page number.  If you print with only
  418.      the page number it will be approximately centered on the bottom
  419.      of the page.  The footer (F) component contains the filename,
  420.      file date, file time and the line that runs across the page bottom.
  421.  
  422.           Finally, the last bit of information is self-explanatory.
  423.      <Esc> will always stop printing or terminate the viewing of a file.
  424.      If viewing a file it will put you back at the file directory. Pressing
  425.      the ALT-X combination will immediately exit the program and put
  426.      you back at the DOS prompt without displaying the filename list. If
  427.      you tagged files for a list <Esc> will put you back at the picklist.
  428.  
  429.  
  430.  
  431.      C.   PRINTING
  432.  
  433.           At any time you may start printing by pressing the ALT-P key
  434.      combination. Use the ALT - L combination if line numbers are
  435.      desired .   Make sure your printer is on and the paper is
  436.      properly lined up.  It's best to start printing at about one-half
  437.      inch from the top.  This gives the best appearance of vertically
  438.      centered text, including the footer.  Printing will always start
  439.      at the beginning of the file and will print the ENTIRE file, even
  440.      if it was truncated.
  441.  
  442.           While printing you will see several windows.  If you are
  443.      printing only one file ( no files were tagged ) the large central
  444.      window will display the text as it is sent to the printer (or buffer).
  445.      Below this will be displayed a horizontal progress bar that gives
  446.      you percentage of completion.  This is handy in that it allows you
  447.      to easily see the progress of the print job.
  448.  
  449.           If you tagged several files for printing, you will see the
  450.      list of files displayed in the main window rather than the text
  451.      that is printing.  You will however be advised of the status
  452.      of the print job by the progress bar.  The bar starts over for
  453.      each file.  The file that is printing is highlited in the window.
  454.      Files whose printing is complete are diplayed in reverse video.
  455.      The very bottom window will now show on the left, the number
  456.      of total print pages (in case you forgot).  In the central part,
  457.      the page being printed will be shown.  Between this and the progress
  458.      bar you'll have plenty of visual representation of the status of
  459.      your print job.
  460.  
  461.  
  462. **        You can pause printing by pressing <ESC) or the spacebar.
  463.      At this point, any key except <ESC> will resume printing.
  464.      Pressing <ESC> again will terminate the print job and put you back
  465.      in the view mode ( or the file list if files were tagged and
  466.      you are printing from a list).  Therefore, the spacebar can act
  467.      as a toggle to alternately stop and start printing.
  468.  
  469.           If the printer is not on or not online, a message will appear
  470.      to alert you of this.
  471.  
  472.           If no formfeeds are detected, QuickPrint will add them, along
  473.      with a footer that provides the name of the file and it's date and
  474.      time on the left and the page number on the right if the the footer
  475.      toggles are on.
  476.  
  477.  
  478.  
  479.           BLOCK COMMANDS
  480.  
  481.           Pressing F7 turns on the block mode and highlights the line
  482.      the cursor is on.  The beginning of the block is anchored to this line. 
  483.      You may expand the block by moving the cursor up or down but the block
  484.      will always be anchored to the initial line. If you want to change it 
  485.      you need to unmark the block with ALT-U then move the cursor to the 
  486.      new line and press F-7 again.
  487.      
  488.           While the block mode is on, the right hand side of the lower window
  489.      will indicate how many lines are blocked. This is helpful for printing
  490.      purposes. Also, to remind you that text is blocked the word block will
  491.      be displayed in the lower window with a blinking triangle. You may print
  492.      a block by pressing the Alt-P or Alt-L key combinations.  While printing,
  493.      the line number being printed is displayed on the bottom left hand side.
  494.  
  495.           You can lock the block in place by pressing F-8.  The beginning and
  496.      end of the block are locked and the cursor is now free to move around
  497.      without affecting the blocked text.  Be careful when you block text
  498.      then scroll it off the screen.  The text is still blocked and if you
  499.      activate printing the block will print even though it's not being viewed
  500.      on the current screen.  When you lock the block with F-8, the word block
  501.      in the lower bar will be surrounded with [brackets] and the little
  502.      blinking triangle will be replaced by the opening bracket.
  503.  
  504.           When you print a block the program will send footers and formfeeds
  505.      to the printer so if you blocked more than one page of text it will skip
  506.      over the perforation. However, it will not issue a formfeed at the
  507.      end of printing. This is to enable you to be able to print several
  508.      small blocks on one sheet of paper. Be careful though. If you print
  509.      several small blocks on one page the program does not know where the
  510.      perforation is so you should manually send a formfeed (ALT-F) when you
  511.      get near the bottom of the page.
  512.  
  513.           Once you have completed printing a block you can unmark it
  514.      by pressing ALT-U. Press F7 to start the block mode again.
  515.  
  516.  
  517.      D. FINAL COMMENTS
  518.  
  519.           Since reading the file is disk intensive, it would be faster
  520.      to use your hard disk if available.  This becomes especially
  521.      important for long files.
  522.  
  523.           QuickPrint stores the file in memory in slightly smaller than
  524.      65K chunks.  It would allow more of the file to fit in memory if
  525.      memory was contiguous and not "chopped up" by other programs.
  526.      Rebooting the computer will give you the largest possible
  527.      contiguous piece of memory.  Any TSR programs, RAM print buffers,
  528.      disk-caches, etc. will decrease available RAM for use by
  529.      QuickPrint.
  530.  
  531.           This program has been compressed with LZEXE91. This is an
  532.      excellent compression program that compresses executable files
  533.      and the program still remains executable - you don't have to wait
  534.      for it to decompress.  You will notice that it can be compressed
  535.      no further by using other compression utilities such as ARC or ZIP.
  536.  
  537.           In order to keep this a simple to use program it is minimally
  538.      configurable. * The configurable settings are now automatically
  539.      saved when you exit the program *. They will be the new default values
  540.      when the program is started up again. The values are saved in a file
  541.      called QP.CFG which is created the first time the program is run and
  542.      is stored in the same directory as QP.EXE. If the program can't find
  543.      QP.CFG it will use the original default values.
  544.  
  545.           There are no command line "switches".  If you like
  546.      this program but would like some minor changes made, let me know.
  547.      I'll see what I can do to accommodate you. If you have a monochrome
  548.      VGA monitor I can provide you with a version that is configured with
  549.      colors that are more appropriate for the gray shading of these monitors.
  550.  
  551.           I am interested in your questions or comments.  Please feel
  552.      free to contact me at the following address or on CompuServe.  My
  553.      CompuServe ID number is 71541,743. I may also be contacted on GEnie,
  554.      where my address is J.DEROSE1.  If you like or even dislike this
  555.      program I encourage you to let me know.  Your responses are what
  556.      keeps me motivated to improve the program. All the changes in
  557.      previous versions  were the result of user's suggestions.
  558.  
  559.           Enjoy!
  560.  
  561.           Thank you.
  562.  
  563.  
  564.      Joseph L. DeRose
  565.      825 Dora Place
  566.      Bel Air, Maryland 21014
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.        APPENDIX A
  582.      Summary of key combinations and examples of the status bars.
  583.  
  584.      F1    : Help screen.
  585.      ALT-P : PRINTS the document without line numbers.
  586.      ALT-L : PRINTS the document with line numbers.
  587.      ALT-M : Adds or changes the MARGIN on the left side.
  588.      ALT-N : Changes the number of LINES PRINTED per page.
  589.      ALT-C : COUNTS the number of pages that will be printed
  590.              taking into account the number of lines printed
  591.              per page.
  592.      ALT-F : Send FORMFEED to printer.
  593.      ALT-R : Send LINEFEED to printer.
  594.      ALT-D : UNTAG all filenames.
  595.      Space Bar : TAG/UNTAG a filename.
  596.      ALT-X : EXIT program without returning to directory.
  597.      ALT-F5: Toggles printing of (F)ooter.
  598.      ALT-F6: Toggles printing of page (N)umber.
  599.      F7    : Turns on BLOCK.
  600.      F8    : Locks BLOCK.
  601.      ALT-U : UNmarks BLOCK.
  602.      ALT-W : Characters printed per line ( text width )
  603.  
  604.      ALT-F2: Delete a file.
  605.      ALT-F3: Rename a file.
  606.  
  607.                                                                           
  608.  
  609.      UPPER BAR
  610.  
  611.   File: <FILENAME.EXT>       < F1 for  HELP >  Txt Width= 80  Page: ##
  612.                     ^                          ^              ^
  613.                     |                          |              |
  614.                     |      Width of printed text              |
  615.                     |      Number of Print Page You Are Viewing
  616.                     Print Document
  617.  
  618.  
  619.  
  620.  
  621.  
  622.  
  623.      LOWER BAR
  624.  
  625.  Line: ###     TOP [BLOCK]  4 pages    Li= 58  M= 0  TR      <ESC> to Quit
  626.  ^             ^    ^       ^          ^        ^    ^                  ^
  627.  |             |    |       |          |        |    Truncation         |
  628.  |             |    |       |          |        Margin - Left Side      |
  629.  |             |    |       |          Lines Printed per Page           |
  630.  |             |    |       Num of Pages to Print                       |
  631.  Line Number   |    Displayed When in Block Mode                        |
  632.  of Text       "TOP" When at the Top of File                            |
  633.                "END" When at the End of File                            |
  634.                                                                         |
  635.                   This will be Replaced with the Number of Blocked Lines
  636.                   when the Block Function is on.
  637.  
  638.      
  639.  
  640.  
  641.      LOWER BAR WHEN PRINTING
  642.  
  643.  Pages: 4           Printing: 2        Li= 58  M= 0          <ESC> to Quit
  644.         ^                     ^
  645.         |                     |
  646.         |                     Page Being Printed
  647.         |
  648.         Number of Pages That Will be Printed
  649.